home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XSetCommand.z / XSetCommand
Encoding:
Text File  |  2002-10-03  |  4.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeettttCCCCoooommmmmmmmaaaannnndddd((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))   XXXXSSSSeeeettttCCCCoooommmmmmmmaaaannnndddd((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSetCommand, XGetCommand - set or read a window's WM_COMMAND
  10.           property
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           XSetCommand(_d_i_s_p_l_a_y, _w, _a_r_g_v, _a_r_g_c)
  14.                 Display *_d_i_s_p_l_a_y;
  15.                 Window _w;
  16.                 char **_a_r_g_v;
  17.                 int _a_r_g_c;
  18.  
  19.           Status XGetCommand(_d_i_s_p_l_a_y, _w, _a_r_g_v__r_e_t_u_r_n, _a_r_g_c__r_e_t_u_r_n)
  20.                 Display *_d_i_s_p_l_a_y;
  21.                 Window _w;
  22.                 char ***_a_r_g_v__r_e_t_u_r_n;
  23.                 int *_a_r_g_c__r_e_t_u_r_n;
  24.  
  25.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  26.           _a_r_g_c      Specifies the number of arguments.
  27.  
  28.           _a_r_g_c__r_e_t_u_r_n
  29.                     Returns the number of arguments returned.
  30.  
  31.           _a_r_g_v      Specifies the application's argument list.
  32.  
  33.           _a_r_g_v__r_e_t_u_r_n
  34.                     Returns the application's argument list.
  35.  
  36.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  37.  
  38.           _w         Specifies the window.
  39.  
  40.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  41.           The _X_S_e_t_C_o_m_m_a_n_d function sets the command and arguments used
  42.           to invoke the application.  (Typically, argv is the argv
  43.           array of your main program.)  If the strings are not in the
  44.           Host Portable Character Encoding, the result is
  45.           implementation-dependent.
  46.  
  47.           _X_S_e_t_C_o_m_m_a_n_d can generate _B_a_d_A_l_l_o_c and _B_a_d_W_i_n_d_o_w errors.
  48.  
  49.           The _X_G_e_t_C_o_m_m_a_n_d function reads the WM_COMMAND property from
  50.           the specified window and returns a string list.  If the
  51.           WM_COMMAND property exists, it is of type STRING and format
  52.           8.  If sufficient memory can be allocated to contain the
  53.           string list, _X_G_e_t_C_o_m_m_a_n_d fills in the argv_return and
  54.           argc_return arguments and returns a nonzero status.
  55.           Otherwise, it returns a zero status.  If the data returned
  56.           by the server is in the Latin Portable Character Encoding,
  57.           then the returned strings are in the Host Portable Character
  58.           Encoding.  Otherwise, the result is implementation-
  59.           dependent.  To free the memory allocated to the string list,
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeettttCCCCoooommmmmmmmaaaannnndddd((((3333XXXX11111111))))  XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))   XXXXSSSSeeeettttCCCCoooommmmmmmmaaaannnndddd((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           use _X_F_r_e_e_S_t_r_i_n_g_L_i_s_t.
  75.  
  76.      PPPPRRRROOOOPPPPEEEERRRRTTTTIIIIEEEESSSS
  77.           WM_COMMAND
  78.                     The command and arguments, null-separated, used to
  79.                     invoke the application.
  80.  
  81.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  82.           _B_a_d_A_l_l_o_c  The server failed to allocate the requested
  83.                     resource or server memory.
  84.  
  85.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  86.                     defined Window.
  87.  
  88.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  89.           XAllocClassHint(3X11), XAllocIconSize(3X11),
  90.           XAllocSizeHints(3X11), XAllocWMHints(3X11),
  91.           XSetTransientForHint(3X11), XSetTextProperty(3X11),
  92.           XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11),
  93.           XSetWMIconName(3X11), XSetWMName(3X11),
  94.           XSetWMProperties(3X11), XSetWMProtocols(3X11),
  95.           XStringListToTextProperty(3X11)
  96.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.